home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 201-220 / scopedisk205 / sidereal / readme < prev    next >
Encoding:
Text File  |  1995-03-20  |  5.3 KB  |  147 lines
  1. Sidereal V1.0                                John Mintalar 10/04/91
  2. ­­­­­­­­­­­­­
  3.  
  4.      This program is a real-time sidereal clock.  It displays the
  5. Universal Time (UT), Greenwich Sidereal Time (GST), and
  6. Local Sidereal Time (LST) for a location given the
  7. daylight savings time adjustment, time zone, geographical longitude,
  8. and local date and time.  Principal users of a program such as this would
  9. be people who are into astronomy.
  10.  
  11.  
  12. Operating System Requirements
  13. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  14.  
  15.      This program was developed on a Amiga 2000 using WorkBench 1.3
  16. with a CBM 68030 accelerator board installed.  I have tested the program in
  17. both 68000 and 68030 modes with no problems.  The program is less than 18K
  18. in size so you shouldn't have memory problems, but, if there is a problem,
  19. my CompuServe ID is listed at the end of this document where you can send
  20. me EMail about problems with the program.
  21.  
  22. Set-Up
  23. ­­­­­­
  24.  
  25.      I have tried to make this program as user-friendly as possible.
  26. There are two (2) ways this program can be used.  One is that it can
  27. be run from the WorkBench screen by clicking on its icon.  Second, it
  28. can be run from a CLI window.
  29.  
  30. Note:  It is important that your Amiga System Date and Clock are set
  31. properly for your location.  If these are not set properly, the
  32. sidereal time displayed when you run the program will not be correct.
  33.  
  34.  
  35. Running  Sidereal  from the WorkBench
  36. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  37.  
  38.      To properly use  Sidereal  from the WorkBench, the
  39. following information will be needed to setup the ToolTypes values for
  40. the icon:
  41.  
  42.      o    Daylight savings adjustment
  43.      o    Time zone
  44.      o    Geographical longitude
  45.  
  46.  
  47. Daylight savings adjustment:  This is the number of hours your local
  48. time is pushed ahead when Daylight Savings time is in effect.  When
  49. STANDARD time is in effect, this value will be zero (0).
  50.  
  51. Time zone:  This is the number of hours your local time is ahead of or
  52. behind Greenwich Meridian time.  For example, if your location is in
  53. the Eastern Standard time zone of the USA, this value would be -5;
  54. Central Standard time zone, this value would be -6, etc.  Note that
  55. time zones WEST of the Greenwich Meridian are negative values; EAST of
  56. the Greenwich Meridian are positive values.
  57.  
  58. Geographical longitude:  This is your location measured from the
  59. Greenwich Meridian in degrees, minutes, and seconds on the world map.
  60. Again, if your location is WEST of the Greenwich Meridian, this value
  61. will be negative.
  62.  
  63.  
  64. Setting up ToolTypes
  65. ­­­­­­­­­­­­­­­­­­­­
  66.  
  67. 1.   Click once on the  Sidereal  icon and select Info from the
  68. WorkBench menu.
  69.  
  70. 2.   In the TOOL TYPES section of the display, use the up/down buttons
  71. to scroll the TOOL TYPES values.  Following is a list of the required
  72. values:
  73.  
  74.      o    DaylightSavings
  75.      o    TimeZone
  76.      o    GeogLongDeg
  77.      o    GeogLongMin
  78.      o    GeogLongSec
  79.  
  80. 3.   Change the values to the right of the 'equal' sign to the
  81. appropiate values for your location.  (Remember:  If your TimeZone and
  82. Geographical Longitude are WEST of the Greenwich Meridian, these
  83. values will be negative).  In the case of the Geographical Longitude,
  84. ToolType values  GeogLongDeg  GeogLongMin  GeogLongSec  separately
  85. will make up your Geographical longitude.  If it is negative, only
  86. GeogLongDeg  needs the negative value.  For example:
  87.  
  88.        GeogLongDeg=-90
  89.        GeogLongMin=10
  90.      * GeogLongSec=11.01
  91.  
  92.      * This value is the only one that should have a decimal number
  93.  
  94. 4.   After insuring that the proper values for your location have been
  95. entered for all the ToolType values, click on SAVE in the lower
  96. left-hand corner.
  97.  
  98. 5.   Double-click on the  Sidereal  icon to run.  The Local Date,
  99. Local Time, Universal Time, Greenwich Sidereal Time, and
  100. Local Sidereal Time should be displayed in a window.  Click on the
  101. CLOSE button (upper left-hand corner) to stop the program.  To move
  102. the window, use the drag bar at the top of the window.
  103.  
  104.  
  105. Running  Sidereal  from the CLI
  106. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  107.  
  108.      This option allows you to change the values of Daylight Savings,
  109. Time Zone, and Geographical Longitude at will.
  110.  
  111. 1.   Open a CLI or SHELL window if one is not already open.
  112.  
  113. 2.   Use the  cd  command to set the current directory to the
  114. directory where the  Sidereal  program resides.  If the directory
  115. where  Sidereal  resides is in your 'path', this step will not be
  116. necessary.
  117.  
  118. 3.   Type  sidereal ?  at the prompt to view help for the  Sidereal
  119. program.  This is the easiest way to learn how to use the program from
  120. the CLI.
  121.  
  122. 4.   When entering values that will be passed to the  Sidereal
  123. program, ensure that they are in the correct order, there is a space
  124. between each value, and that the correct number of values is passed
  125. to the program.  If you enter too many values or less than the
  126. required, the help text will be displayed.
  127.  
  128. Note:     If you type in  sidereal  with no parameters, the following
  129. defaults will take effect:
  130.  
  131.      Daylight Savings......:  0
  132.      Time Zone.............:  0
  133.      Geographical Longitude:  0 0 0.00
  134.  
  135. Effectively, this is the Greenwich Meridian, Standard time.
  136.  
  137.  
  138. Questions, Comments, Suggestions, Bugs?
  139. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  140.  
  141.      If you have any questions or comments about this program or have
  142. suggestions for the program, send EMail at the CompuServe address listed
  143. below.  If you find a bug(s) in the program, also, let me know.
  144.  
  145. John Mintalar  CompuServeID: [76426,302]
  146.  
  147.